跳到主要内容

使用 API 添加和管理连接

使用 API 添加和管理集成 - 主图

通过我们的 API，您可以将其他软件连接到 Notion，自动化工作区内的操作，并访问由合作伙伴构建的连接 🤖​

目录

  • 在您的工作区中添加连接
  • 将连接添加到页面
  • 在您的工作区中管理连接
  • 企业级连接设置
  • 限制成员安装连接
  • 自动批准 Notion 构建的连接
  • 已批准的连接列表
  • 从开发者处安装
  • 通过 OAuth 直接从合作伙伴平台安装
  • 使用内部集成令牌进行安装

想要使用 Notion 的 API 构建强大的工作流程和集成吗？请访问我们的开发者中心获取文档、资源和集成管理工具。 注意： 在企业计划中，以下功能可能会限制为工作区所有者：

在您的工作区中添加连接​

成员可以在 设置与成员 → 我的连接 中向工作区添加连接。工作区所有者可以在 设置与成员 → 连接 中向工作区添加连接。一旦添加了一个连接，它就可以被添加到更多页面上。

将连接添加到页面​

使用 API 构建的连接遵循类似于 Notion 用户共享权限的权限系统。要在您的工作区中使用一个连接，您需要将其添加到具体活动页。

  1. 导航至某一页并选择右上角的 •••。
  2. 在弹出窗口底部点击 Add connections。
  3. 在弹出窗口中搜索并选择要将其添加到此页的链接。您只会看到已为该工作空间创建并关联起来的链接。

add connection menu

  • 现在，该连接将出现在页面的 ••• 菜单中。

  • 如果您想从页面中删除一个连接，请将鼠标悬停在其名称上，然后按下 断开连接。

管理工作区中的连接​

注意： 只有工作区所有者可以管理工作区中的所有连接。成员只能访问他们创建的连接。

  • 在左侧边栏中，导航到 设置和成员，然后选择 Connections 选项卡。

  • 在这里，您会看到两个选项卡：成员 和 工作区.

  • 从 成员 选项卡中，您可以管理成员可以访问的集成。具体来说，您可以限制集成访问权限为批准列表上的集成功能，并查看谁正在使用内部集成功能，并断开工作区内任何集成功能的使用。

  • 注意：只有企业工作区所有者才能限制对批准列表上集成功能的访问权限。

  • 从 工作区 选项卡中, 您可以安装和管理整个企业工作空间所需的安全与合规性集成功能。 添加和管理集成 - 集成菜单

  • 点击连接旁边的 ••• 以查看其他选项：

  • 检索内部 API 令牌

  • 访问开发者网站或联系他们的支持团队

  • 查看具有访问权限的用户

  • 断开连接

企业连接设置​

如果您的工作区使用企业计划，工作区所有者将可以访问额外的设置来管理工作区内的连接。

限制成员安装连接​

  • 如果您是工作区所有者，请转到 设置与成员 → Connections。

  • 在 Member 标签下，您将看到一个选项：Restrict members from adding connections（限制成员添加连接）。点击右侧的下拉菜单以访问两个选项：

    • No restrictions（无限制）: 所有工作区成员都可以在工作区中安装任何连接。

    • Only from approved list（仅限已批准列表）: 工作区成员只能安装工作区所有者预先批准的连接。如果工作区所有者安装了尚未在已批准列表中的集成，它将自动添加到已批准列表中。

集成 - 企业菜单

自动批准 Notion 构建的连接​

集成 - 自动批准

已批准连接列表​

  • 点击“+ 添加已批准的连接”按钮，为工作区成员批准其他连接。

**注意：**在您可以为工作区的其余部分批准连接之前，您或其他管理员必须先安装它！只有已经安装在工作区中的连接才会显示在“+ 批准的连接”下拉菜单中。

安装连接的说明如下所示：

  • 在“已批准的连接”标题下，工作区所有者将看到一个完整列表，其中列出了已经被批准并安装在工作区中的连接。

  • 在每个连接名称右侧，列出了已经在工作区中安装该连接的用户姓名。

  • 点击 ••• 菜单可以进行以下操作：

    • 按用户筛选

    • 撤销特定用户对某个连接的访问权限

    • 断开所有用户

    • 将该连接从已批准列表中移除

集成选项

从开发者处进行安装​

查看我们的集成画廊 →​

直接通过 OAuth 从合作伙伴平台安装​

Notion 直接与几个服务（例如 Zapier 和 Typeform）合作。您可以通过 OAuth 直接在这些服务的网站上将我们的合作伙伴公共连接添加到您的工作区。

  • 在合作平台的应用菜单中搜索 Notion 并添加它。

  • 在生成的身份验证菜单中，合作伙伴连接会要求您允许访问您的工作区。所需连接级别将被指定。

  • 连接是特定于工作区的！如果需要，点击右上角的工作区名称切换到另一个工作区。然后，按下 选择页面。

添加和管理集成 - OAuth

  • 现在，您将看到所选工作区中所有页面的列表。选择希望该连接能够访问的页面，然后按下 允许访问。

  • 完成身份验证后，在您工作区的 设置和成员 菜单 → Connections 中将会看到此连接。

  • 单击连接名称旁边的 ••• 菜单，可以访问开发者的网站、联系开发者支持团队或断开与工作区的连接。

添�加和管理集成 - 公共集成菜单

提示： 想要看到一些合作伙伴集成的实际效果吗？查看此指南 →

通过内部集成令牌安装​

某些合作伙伴平台需要使用内部集成令牌才能链接到您的工作区。

  • 在这种情况下，请首先按照以下说明为您的工作区创建相应的内部集成。

  • 创建完内部集成后，转到侧边栏中的 设置和成员，然后选择 连接 选项卡。

  • 单击要链接到合作伙伴平台的现有连接旁边的 ••• 菜单，并点击 复制内部集成令牌。

添加和管理集成 - 内部集成令牌

  • 将此内部集成功质粘贴到合作伙伴平台设置表单上对应的字段中。

注意： Notion 不支持解决合作伙伴整合问题。请将任何反馈和问题直接发送给相关合作方支持团队。